home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Resource Library: Multimedia
/
Resource Library: Multimedia.iso
/
_archive
/
archivrs
/
msdos
/
arj230ng.exe
/
UPDATE.DOC
< prev
next >
Wrap
Text File
|
1992-01-19
|
22KB
|
638 lines
UPDATE.DOC, ARJ 2.30 January 1992
This documents new or updated information since ARJ 2.21.
** IMPORTANT NEWS ****************************************************
The next release, ARJ 2.40, is coded and is now undergoing ALPHA
testing. This version will provide a significant increase in
compression speed by using a variation of the ARJ method 3
compression which has always been FAST.
Whenever archiving to diskettes, it is HIGHLY recommended that
the option "-jt" be used. This helps spot BAD diskettes or
diskette drives. It is HIGHLY recommended that the "-jt" option
be used in a multi-tasking or network environment.
File sharing violations have been reduced to a rare occurrence
even on file deletes. ARJ now opens input files in a shared
read mode. In addition, an option to trap all DOS critical
errors is available.
The ARJ 2.30 default compression method (-m1) has been modified
to increase compression in most cases, but it uses at least 20K
bytes MORE MEMORY than previous versions of ARJ. The ARJ 2.30
option (-m2) is similar to the default of previous versions of
ARJ in compression and memory usage.
The "ARJ d archive *.*" will now prompt for permission to
complete the deletion. If ARJ removes all of the files from an
archive, it will delete the archive.
There is a new main header flag (0x20) which indicates that an
archive is a "backup type". There is a new local header flag
(0x20) which indicates that an internal archive file is a backup
file.
The "-jo" option has new functionality in extract commands.
Unless the "-jr" (recover) switch is used, ARJ will delete any
file extracted with a CRC or Bad file data error.
The ARJ 2.30 "m" (move) command and "-d" option will NOW delete
directories selected with the "-a1" option.
The 2.21 version of ARJ does NOT correctly garble (-g option)
stored (-m0) files larger than 32767 bytes. ARJed GIFs and
archives may have this problem, since ARJ reverts to storing
when unable to compress the file. Archived files with this
problem will test/extract with a CRC error. ARJ 2.21a, 2.22,
and 2.30 have an option "-h+" to CORRECTLY extract such files.
This option may not be supported in future ARJ releases.
Example: ARJ x archive -gpassword -h+
If the garbled archived file is the last file in an ARJ multiple
volume archive, you may have to use the "-h+1" or "-h+2" option.
You should specify the filename to ARJ.
Example: ARJ x archive filename -gpassword -h+1
You should extract all 2.21 GARBLED (-g) archives and re-archive
with ARJ 2.30. If you created 2.21 GARBLED self-extracting
archives, you should extract these and re-archive them. I
apologize for any inconvenience this has caused.
Those of you who always use the "-jt" option to test while
ARJing should have very few problem archives.
There is a workaround for the problem of using STAGED writes to
the floppy disk when using HYPERDISK and ARJ multi-volume mode.
See the KNOWN ARJ ISSUES section in ARJ.DOC for details.
The ARJ LICENSE.DOC has been updated.
**********************************************************************
BACKUP TYPE ARCHIVES AND BACKUP FILES
New to ARJ 2.30 and ARJ archives is the concept of "backup" type
archives. Normally, when adding duplicate files to an ARJ archive,
ARJ will overwrite the existing file. However, at ARJ 2.30 with a
backup type archive, ARJ will keep the existing file by marking it
as a backup and inserting the new file. This will make ARJ
archives larger than normal.
This feature is useful when backing up frequently modified files.
One archive can have several days worth of backups.
See ARJ.DOC for more details concerning BACKUP type archives.
ARJ COMMAND LINE PROCESSING
ARJ's option to leave off the ending "\" on the base directory
name on the command line will only work for the following
commands: A, B, E, F, J, M, U, X. For a command such as "ARJ t
-jt1 archive dir\", the ending "\" is required.
Concatenated switch options are NOW supported. You may combine
"-i" and "-k" to form "-ik" to save command line length. See
ARJ.DOC for details.
ARJ will now accept an ending "-" on most switches such as "-w-".
The "-x" switch is one exception. The one caveat is that for
switches that support an argument such as "-wd:\", that switch
option must not be followed by a concatenated switch option such as
"-w-r". An option string such is "-rikw-" is acceptable because
the "-w" option is the last one.
ARJ COMMANDS
"b" command
The ARJ b command allows a user to execute a DOS command on
selected files in an archive. The ARJ b command will prompt for a
DOS command string to execute per selected file. By default ARJ
will extract the selected files to the filename ARJTEMP.$$$. This
filename can be changed with the "-jw" option. The base directory
option is ignored by the ARJ b command. The output file will be
deleted by ARJ after the DOS command is executed.
Examples: ARJ b archive
ARJ b archive -jwtemp\tempfile
This option can substitute for a simple extract and run command
where the file to be extracted is an executable. You would specify
a temporary executable name as the output name and use that name as
the DOS command to be executed.
Example: ARJ b archive file.exe -jwTEMP.EXE
TEMP arguments
You can supply the DOS command string on the command line with the
"-jq" option. Switch options which have embedded blanks must be
enclosed by double quote marks.
Examples: ARJ b archive file.exe -jwTEMP.EXE -jqTEMP
ARJ b archive *.c "-jqgrep text ARJTEMP.$$$ >> output"
"c" command
To strip archive or file comments from an archive, you can use
the NUL file feature of MS-DOS.
Examples: ARJ c archive -zNUL strips archive comment
ARJ c archive name -jzNUL strips comment for "name"
ARJ c archive -jzNUL strips all file comments
ARJ c archive -zNUL -jzNUL strips all comments
"d" command
If specify "*.*" as the filespec, ARJ will prompt for permission to
delete. You can specify the "-y" or "-jyd" options to inhibit the
delete prompt.
If ARJ removes all files from an archive, it will delete the empty
archive.
The delete command normally only deletes non-backup files. You
must specify the "-jg" option to select backup files, too.
You can specify the "-n" (new) option to delete the files in the
archive that DO NOT EXIST on the disk. You can use the same "-n"
option with "ARJ l" to list the files that DO NOT EXIST on the
disk.
Examples: ARJ d archive *.* -n
ARJ d archive temp\ *.doc -n
"e", "x" command
The ARJ e and ARJ x commands now accept the "-d" option to provide
an extract and delete option. This feature requires that you
specify the files to extract and delete. This option actually uses
more disk space than a simple extraction because of the temporary
archive that is created during the extraction process.
If ARJ removes all files from an archive, it will delete the empty
archive.
"g" command
The ARJ g command allows a user to garble an already built ARJ
archive. Please note that only ungarbled files will be garbled by
the ARJ g command.
Example: ARJ g archive -gdinosaur
"k" command
The ARJ k command works similar to the ARJ d command except that
the ARJ k command only deletes files marked as backups. The ARJ k
command requires a wildname or filespec as a selection option.
Examples: ARJ k archive *.*
ARJ k archive *.doc -y
If specify "*.*" as the filespec, ARJ will prompt for permission to
delete. You can specify the "-y" or "-jyd" options to inhibit the
delete prompt.
"l" command
The "l" and "v" displays have been changed to indicate files that
are marked as backups by an "*" in the column right after the file
attributes.
When ARJ has detected a set backup flag in an archive, there will
be a message "[Backups ON]". When ARJ has detected any backup
files in an archive, there will be a message "[Backup(s) found]".
The "-jg" option is needed to set the "l" and "v" commands to
display the names of backup files. The "-jg1" option can be used
to display ONLY the names of backup files.
Example: ARJ l archive -jg
You use the "-n" option with "ARJ l" to list the files that DO NOT
EXIST on the disk.
"m" command
The m command supports the deletion of directories when the "-a1"
option is used to select and archive the directories. Directory
delete errors will occur if not all of the files in a directory are
selected.
NOTE that the top directory in the following command is NOT
selected and NOT deleted: "ARJ m archive dir\*.* -r -a1
"v" command
The "v" command now displays a sequence number preceding the
pathname. This number can be used with the "-#" option to access
specific files within an archive.
Example: ARJ v archive -jg
ARJ x archive -# 5 10
"w" command
The ARJ w command now supports the use of the "-jp" option to
page the display.
The "-jq" option can be used to supply the necessary parameters to
the ARJ w command.
The option string will be parsed as follows:
1) the first character must be either "+" or "-" indicating yes or
no,
2) the next characters are the number of lines of context to display,
3) the next character is the search text delimiter,
4) the next characters are the search string optionally followed by
another delimiter and another search string, etc.
Examples: ARJ w archive -jq+3+total
caseless search, display 3 lines, search for "total".
ARJ w archive "-jq-2-to be-that is the-seas"
case sensitive search, display 2 lines,
search for "to be", "that is the", and "seas".
The search text delimiter cannot be a character in any of the
search strings.
"y" command
The ARJ y command provides a easier interface to the -je and -je1
options as well as to the new -jb, -jb1, and -jb2 options.
Basically, the y command copies the entire archive to itself.
Examples: ARJ y archive -je1 convert an archive to an SFX
ARJ y archive -jb make an archive a backup type
ARJ y archive -jb1 reset the generation flag
ARJ y archive -jb2 unmark all backup files
ARJ SWITCHES
If the ARJ_SW environment variable specifies a filename (text not
beginning with a switch character), ARJ will open that filename and
scan it looking for a line of text that begins in column 1 with the
same letter as the ARJ command being executed. The following text
is processed as the ARJ_SW switches. This allows each ARJ command
to have its own switch settings. In addition, ARJ will also look
for the "+" (plus) symbol in column 1 to use as a miscellaneous
switch string. This string will be added to any command switch
string found if any. If no command switch string is found, ARJ
will use the miscellaneous switch string as the ARJ_SW switch
settings. NOTE that the "+" switch settings will NOT be used
if the "+" string occurs below the command switch string.
SET ARJ_SW=C:\ARJ\ARJ.CFG
C:\ARJ\ARJ.CFG contains:
a -jm1 -jt -i1
c -zcomment.txt
+ -jv
l -jp
e -i1
AND is equivalent to:
a -jm1 -jt -i1
c -zcomment.txt
l -jp -jv
e -i1 -jv
f -jv
v -jv
all other commands
.
.
.
"-+" switch
The "-+" option can now be used to specify an environment variable
name to use in place of the default "ARJ_SW". This option can only
be used on the command line.
Example: ARJ a archive -+ARJ_SW2
"-&" switch
The "-&" option sets ARJ to install a critical error handler. This
handler will intercept errors that produce the "Abort, Retry ..."
error messages like bad sector errors and file sharing violations.
It can be specified on the command line or via the environment
variable. Please note that if you specify "-&" on the command
line, the handler is installed immediately before any files are
processed. If you specify "-&" in the environment, ARJ will not
install the handler until all switches are processed.
Unattended or BBS uses of ARJ should use the "-&" switch.
You can only use "-&-" to disable this switch.
"-#" switch
The "-#" option allows the user to select files from an archive by
their order number in the archive. For example, the number 1
selects the first file in the archive. This option is useful in
selecting files where there are duplicates in the archive. It is
also useful for batch type utilities that need to extract files
sequentially from an archive for processing.
You can specify a series of files with the n1-n8 type syntax. No
embedded spaces are allowed.
ARJ e archive -# 1 4 12-25 40-100
NOTE that the order number starts from 1 for each individual
archive including multiple volume archives. In other words, the
first file in archive.a04 is number 1.
Do NOT mix filenames with the numbers other than the base
directory.
Example: ARJ e -# archive basedir\ 1 3 5 20 21
"-d" switch
The "-d" option supports the deletion of directories when the "-a1"
option is used to archive the directories. Directory delete errors
will occur if not all of the files in a directory are selected.
"-g?" switch
If the "-g" option is followed by a question mark "?", ARJ will
prompt the user for the password without displaying the password
input. The backspace key can be used to erase characters.
"-m" switch
The "-m1" and "-m2" compression methods have been modified to
improve the compression ratios. The new "-m1" (default) method
is almost the same as using the "-m1 -jm1" of previous versions.
"-n" switch
The "-n" option can be used with the ARJ "d" and "l" commands to
select only those files in the archive that DO NOT EXIST on disk.
"-o" switch
ARJ now accepts the use of "-o" and "-ob" options simultaneously to
specify a range of selected dates. This is useful for selecting
files on a specific date.
Example: ARJ a archive *.* -o910101 -ob910102
The "-o" option and/or the "-ob" option will default to today's
date at midnight (0000 hrs) when specified without dates.
"-t1" switch
The "-t1g" switch will allow archival and extraction of 8-bit
text files. Graphics characters will NOT be stripped. However,
when such archives are moved to a different host machine (IBM to
AMIGA), ARJ will strip the text to 7-bit text.
The text mode testing for binary file will check for too many
graphics characters.
You should NOT use the "-t1" switch while archiving in multiple
volume mode.
Please note that the new "-jt1" option does NOT provide extra
security against using text mode on the WRONG type of file.
"-v" switch
ARJ normally only creates volumes numbered up to .A99 for one
hundred uniquely named volumes. Then the numbers roll over to
.A00. When the archive name ends in .000, ARJ will create volumes
numbered up to .999 for one thousand uniquely named volumes.
Example: ARJ a -v720 -y -r archive.000 d:\
For those who want volumes to be identified in a more numerical
order, you can specify the initial archive with an appropriate
suffix such as .A01 or .001. In this way, you can have ALL volumes
ending in numeric suffixes starting from "1" or whatever.
The modifier "w" specifies to ARJ that files are NOT to be split
across volumes except for one case. That case is where the
archived file would not fit in ONE whole volume. This feature does
not optimize the use of space in these type of volumes. With this
feature, it is possible to have a volume of only 300 or less bytes.
The modifier "w" must be specified after the "v" modifier and
before the "a" modifier as in -vvwas.
An advantage to "w" type volumes is that updating of these volumes
is supported for the "f"reshen command and other commands that do
not add new files to the archive. You can add files to these
volumes only if you do NOT limit the volume size.
"-jb" switch
If you modify an archive with the "-jb", ARJ sets the backup
flag in the archive. On adding, updating, or moving files to an
backup type archive where a duplicate filename exist, ARJ marks
the original file as a backup and inserts a copy of the duplicate
filename. The backup flag will stay set until reset with the
"-jb1" option.
These backup files take up space in the archive. They can be
purged with the ARJ k command.
Examples: ARJ a -jb archive dir\file1
ARJ e -jb archive dir\file2
ARJ k archive *.c
ARJ y -jb archive just sets the backup flag
Normally, backup files will not be selected by ARJ commands. In
other words, an ARJ l archive command will not display backup
files. However, the "-jg" option will include backup files in the
selection process. For example, ARJ l archive -jg will display all
files including backup files.
"-jb1" switch
This switch allows you to reset the backup flag in a backup type
archive. Addition of files to such an archive will no longer
result in files being marked as backups. However, this option does
not remove already existing backup files.
Example: ARJ y archive -jb1
ARJ a archive filename -jb1
"-jb2" switch
The "-jb2" option is used with the "y" command to unmark files
marked as backups. Note that this may produce duplicate files in
the archive.
Example: ARJ y archive -jb2 unmark all backup files
ARJ y archive *.doc -jb2 unmark all *.doc files
ARJ y archive -# -jb2 5 unmark the 5th file
"-jb3" switch
The "-jb3" option is used with the "y" command to mark files as
backups.
Example: ARJ y archive -jb3 mark all files as backups
ARJ y archive *.doc -jb3 mark all *.doc files
ARJ y archive -# -jb3 5 mark the 5th file
"-jc" switch
The "-jc" option sets ARJ to exit early from an archive scan when
the specified number of files have been extracted, listed, printed,
etc. If no number has been specified, ARJ will set that number to
the number of filename arguments.
WARNING! This count must take into account that ARJ counts split
files in multiple volumes as individual files. In other words, a
file split into three pieces by ARJ counts as three files.
Examples: ARJ e -jc archive file1 file2 file3
ARJ e -jc5 archive *.bat
"-jg" switch
The "-jg" switch allows the user to include the selection of
archive files that are marked as backups by the "-jb" option. Only
the "k" and "y" commands automatically select files marked as
backups. The "-jg1" option allows the user to select ONLY files
marked as backup files.
Examples: ARJ l -jg archive
ARJ e -jg -q archive name.c
ARJ d -jg archive *.*
ARJ l -jg1 archive
"-ji" switch
The "-ji" switch will log the following events:
a, f, m, u - Log actual filenames added to archive and if testing
is enabled, the actual filenames that failed testing.
d - Log archived filenames deleted.
e, x - Log archived filenames successfully extracted.
Extracted files with CRC errors are NOT logged.
j - Log archived filenames added to archive.
l, v - Log archived filenames listed.
t - Log archived filenames that failed testing.
w - Log archived filenames that contain string matches.
"-jo" switch
The "-jo" switch during extraction allows automated handling of
duplicate filenames.
On extraction with the "-jo" switch where the output file already
exists in the target directory, ARJ will attempt to generate a
unique filename by changing the file extension to a 3 digit number
from .000 to .999. If ARJ cannot generate a unique name, it will
skip extracting the file.
Example: ARJ e -jo archive dir\file1
"-jp" switch
You can specify the page size with the "-jp" option as in "-jp50".
This also turns on the pause mode. If you wish to use this in
ARJ_SW, it is suggested that you use "-jp50 -jp" to set the page
size and to toggle off the pause mode.
"-jq" switch
The "-jq" option is used to supply additional parameters to the ARJ
w and ARJ b commands. If the parameters contain blanks, then the
entire "-jq" option must be enclosed by two double quote marks.
"-jr" switch
It is much easier to recover files from a corrupted archive,
because ARJ no longer aborts on encountering a "Bad file data"
(formerly "Bad Huffman code"). This switch is now needed to
extract files with a CRC error.
"-jt" switch
The "-jt" switch can now be used with extract type commands to
set ARJ to verify the archive before doing any extraction of
files. If the archive fails verification, the extraction is NOT
attempted. This is useful for handling MAIL packets where archive
corruption due to a bad file transfer is a fairly frequent event.
"-jt1" and "-jt2" switches
The "-jt1" switch allows an actual file contents comparison in
addition to the normal file CRC calculation check. This option
can also be used with the ARJ t (test) command.
When used with the ARJ t command, ARJ "-jt1" will use the
base_directory option and the filename stored in the archive to
locate the original file.
When used with the ARJ add/move/update type commands, ARJ will use
only the filename stored in the archive to locate the original
file. Therefore, the "-jt1" or "-jt2" options do NOT work with the
"-e" option or when the original filename has a drive letter or
root directory in it and you did not specify "-jf".
Examples: ARJ t -jt1 archive dir\
ARJ a -jt1 archive e:\temp\*.* -jf
The "-jt2" switch allows the same features as "-jt1" except that
the file compares are only done for the newly added/updated files.
This avoids the situation where the some of original input files
are missing or have changed. NOTE that a problem can occur with
the "f" and "u" commands when files in the archive are NEWER than
the files being added. ARJ will considered the file up-to-date and
added and will do a file compare.
The "-ji" option now supports logging of files that fail testing.
end document